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PREFACE 


This instant manual provides calling formats, parameter 
descriptions, default values for all calling sequences, and 
error messages of the CDC® Terminal-Independent 
Graphics System (TIGS). 

This manual is intended for use as a reference source for 
all users of TIGS. A familiarity with FORTRAN is assumed. 

For further information on material in this manual, refer to 
the Control Data Terminal-Independent Graphics System 
(TIGS) Reference Manual, publication number 60455940. 
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TIGS ROUTINES 


The following are the user-level calling sequences for the 
Terminal-Independent Graphics System (TIGS). The 
routines are listed by type (primitives, interaction, and so 
on) with their parameters and a description of what 
function is performed. 


TIGS CALLING SEQUENCES 

The calling sequences are divided into the following 
categories. 

• Primitives 

• Terminal functions 

• Segments and pictures 

• Windows and viewports 

• Transformation matrices 

• Geometry utilities 

• Interaction 

• Error processing 


PRIMITIVES 


ARCxxx 

ARCA(coc,cy,x,y) 

ARCA3(cjc,cy,cz,x,y,z, 

xdir,ydir,zdir) 

ARCDA(cx,cy,deg) 

ARCDA3(cx,cy,cz, 

ddeg,xdir,ydir,zdir) 


Draw absolute 2-D arc to 
endpoint. 

Draw absolute 3-D arc to 
endpoint. 

Draw absolute 2-D arc 
through angle. 

Draw absolute 3-D are 
through angle. 
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ARCDRicdx.cdy.ddeg) 

ARCDRSicdx.cdy.cdz, 

ddeg,xdir,ydir,zdir) 

ARCRicdx,cdy,dx.dy) 

ARCR3{cdx,cdy,cdz, 

dx,dy,dz,xdir,ydir, 

zdir) 

DOTxx 

DOTA(x,y) 

DOTA3{x,y.z) 

DOTR(dx,dy) 

DOTR3(dx,dy,dz) 

DRAW XX 
DRAWA(x,y) 

DRAWA3{x.y,z) 

DRAWR(dx,dy) 

DRAWR3(dx.dy,d2) 


I 2 


Draw relative 2-D arc 
through angle. 

Draw relative 3-D arc 
through angle. 

Draw relative 2-D arc to 
endpoint. 

Draw relative 3-D arc to 
endpoint. 


Draw dot at absolute 2-D 
position. 

Draw dot at absolute 3-D 
position. 

Draw dot at relative 2-D 
position. 

Draw dot at relative 3-D 
position. 


Draw line to absolute 2-D 
endpoint. 

Draw line to absolute 3-D 
endpoint. 

Draw line to relative 2-D 
endpoint. 

Draw line to relative 3-D 
endpoint. 
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MOVExx 


MOVEA(x,y) 

MOVEA3U,y,z) 

MOVER(dx,dy) 

MOVER3(dJC,dy,dz) 

PLOTxx 

PLOTAinpoint.xary, 
y ary,line] 

PLOTA3{npoint,xary, 
y ary, z ary',line) 

PLOTR(npoint,dxary, 
dy ary,line) 

PLOTR^inpoint.dxary, 

dyary,dzary,line) 

TEXTx 

TEXTinchar.itext) 

TEXT3inchar,itext) 


Move beam to absolute 2-D 
position. 

Move beam to absolute 3-D 
position. 

Move beam to relative 2-D 
position. 

Move beam to relative 3-D 
position. 


Plot symbols at absolute 

2- D endpoints. 

Plot symbols at absolute 

3- D endpoints. 

Plot symbols at relative 

2- D endpoints. 

Plot symbols at relative 

3- D endpoints. 


Draw specified text string 
at current 2-D position. 

Draw specified text string 
at current 3-D position. 


TFNSIZ 

TFNSIZ(nsize) Test to determine number of 

discrete character sizes 
supported by terminal. 
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xxCSIZ 


RACSlZ{idseg,wide,high) 

SMCSIZ(wide,high) 

TACSlZiidseg,widout,hiout) 

TFCSlZilcchar) 

TM CSlZ{widout,hiou.t) 

xxDSIZ 

RADSlZ{idseg,wide.high) 

SMDSIZ(wide,high) 

TADSlZ{idseg,widout,hiout) 

TFDSIZ( wide, high, 
vjidout,hioLLt) 

TMDSIZ(widout,hiout) 

xxFONT 

RAFONT(idseg,ifont) 

SMFONT(ifont) 


Reset continuous character 
size attribute of a segment. 

Modally set continuous 
character size. 

Test continuous character 
size attribute of a segment. 

Test to see if continuous 
character sizes are 
supported. 

Test current modal setting 
of continuous character size. 


Reset discrete character 
size attribute of a segment. 

ModaUy set discrete 
character size. 

Test discrete character size 
attribute of a segment. 

Test to determine best 
character size to use. 

Test current modal setting 
of discrete character size. 


Reset character font 
attribute of a segment. 

ModaUy set character font. 
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TAFONT( idseg.ifont) 


Test character font 
attribute of a segment. 


TFFONT(nfon£) Test to determine number of 

character fonts available on 
a terminal. 

TMFONT(ifont) Test current modal setting 

of character font. 


xxHILT 

RAHlLT(idseg,miZit) Reset highlighting attribute 

of a segment. 

SMHILT(lhilit) Set highlighting mode on or 

off. 


TAHILT(idseg,mi7i£) 


TFHILT(Zhilt) 


TMHILT( ZhiZit) 


Test highlighting attribute 
of a segment. 

Test to determine if 
highlighting of display is 
supported by postprocessor. 

Test current highlighting 
mode. 


xxINT 

RAINT(idseg,finten) 


SMINT(finten) 


TAINT{Zdseg,fZn£en) 


TFINT(nin£en) 


TMINT(finten) 


Reset intensity attribute of 
a segment. 

Modally set intensity 
attribute of a segment. 

Test intensity attribute of a 
segment. 

Test to determine number of 
intensity levels available on 
a terminal. 

Test current modal setting 
for intensity. 
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xxROT 


RAROT(idseg,deg) Reset character rotation 

attribute of a segment. 

SiVIROT(deg) Modally set angle of 

character rotation. 


TAROT(idseg,deg) 


TFROTdninty, i cont) 


TMROT(degj 


Test character rotation 
attribute of a segment. 

Test to determine if 
character rotation by 
90-degree increments is 
supported, and if continuous 
character rotation is 
supported. 

Test current modal setting 
of angle of character 
rotation. 


XXROT3 

RAROT3(idseg,xbase, 
ybase,zbase,xplane, 
y plane, zplane) 

SMROT3{x5ase,ybase, 

zbase,xplane,yplane, 

zplane) 

TAROT3(fdseg,Xjbase, 
ybase,zbase,xplane, 
yplane, zplane) 

TMROT3{xbase,ybase, 
zbase,xplane,yplane, 
zplane) 


Reset 3-D character rota¬ 
tion and plane attribute 
of a segment. 

Modally set rotation angle 
and plane for 3-D char¬ 
acters. 

Test 3-D character rota¬ 
tion and plane attribute 
of a segment. 

Test current modal setting 
of rotation angle and 
plane for 3-D characters. 


xxSTYL 

R AST Y L{ idseg, istyl e) 


SMSTY Liistyle) 

T AST Y L( idseg, istyl e) 


Reset line style attribute of 
a segment. 

Modally set line style. 

Test line style attribute of a 
segment. 
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TFSTYL(lhard) 


TMSTYL(istyZe) 

x-xSYM 

RASYUiidseg.isym) 

SMSYM(isym) 

TASYM(idseg,isym) 

TFSYM(nsym) 

TMSYM(isym) 

xxVIS 

RAVIS(idsegdvis) 
SMVIS(lvis) 
TAVIS(idseg,lvis) 
TFVISd tran) 

TMVIS(Zvis) 


Test for line styles 
supported by terminal 
hardware. 

Test current modal setting 
of line style. 


Reset the plotting symbol 
attribute of a segment. 

Modally set the selected 
plotting symbol for use with 
PLOTxx routines. 

Test the plotting symbol 
attribute of a segment. 

Test for maximum defined 
symbol number in a given 
postprocessor. 

Test current modal setting 
for plot symbol. 


Reset visibility attribute of 
a segment. 

Set visibility mode for 
visible or invisible. 

Test visibility attribute of a 
segment. 

Test to determine if 
complete screen 
retransmission is required to 
make any one segment 
invisible. 

Test current setting of 
visibility mode. 
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TERMINAL FUNCTIONS 

ALARM(ion) 

CLRSCR 

DSPLAY 

INITIG(/squar,InwfiZ, 

filnam) 

QUITIG(Zdelet) 

REMSCR 

SCRNUR(idwmd,xscrn, 
yscrn, xuser,yuser ) 

TFHARD(Zremot) 

TFSCRN(Zrtang,xll,yZi, 

xar.yiir.resltn) 

\JD AT A{nw or ds,idat) 

UNISCR 

WHERE(x,y) 

WHERE3{x.y.z) 


Turn terminal alarm 
indicator on or off. 

Clear all displays from 
terminal screen. 

Display all pictures. 

Set all TIGS and terminal 
conditions to initial values. 

Ensure orderly shutdown of 
terminal at end of program. 

Copy contents of screen on 
remote hardcopier. 

Convert screen coordi¬ 
nates to user coordinates; 
2-D pictures only. 

Test for existence of remote 
hardcopiers. 

Test size, shape, and 
resolution of the terminal 
screen. 

Place user data in neutral 
display file. 

Create picture on UNIPLOT 
NPFILE to reflect current 
state of neutral display file. 

Obtain current beam 
position for 2-D picture. 

Obtain current beam 
position for 3-D picture. 
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SEGMENTS AND PICTURES 


BLINDS(idpict,ldown) 

Control display of all parts 
of picture through all 
windows with which the 
picture is associated. 

CLSPIC 

Close an open picture. 

CLSSEG 

Define end of the currently 
open segment. 

C OP Y( idseg.ne wseg) 

Generate a copy of the 
specified segment and assigr 
it the segment identifier 
newseg. 

DELPIC(idpict) 

Delete specified picture. 

DELSEG(idseg) 

Delete specified segment. 

EMPTY(idseg) 

Delete contents of a 
segment. 

EXTPIC(idpict) 

Add segment to an existing 
picture. 

EXTSEG(idseg) 

Add primitive to an existing 
segment. 

LCKSEG 

Lock currently open 
segment. 

OPNPIC(idpic£) 

Define beginning of a 
picture. 

OPNSEG(idseg) 

Define beginning of a 
segment. 

RENAME(idold,idnew) 

Replace old segment 
identifier idold with new 
identifier idnew. 
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xxPICT 


RAPlCTiidseg.idpict) 

SMPICT(idpict) 

TAPlCTiidseg.idpict) 

TFPICT(npict) 

TMPlCTiidpict) 

xxPLIx 

SMPLmUll.yll.xiLr.yur) 

SMPU2ixllh,yllh,zllh, 

xury,yLLry,zury) 

TAPUMiidseg.xll.yll, 

xar,yur) 

TAPLl3(idseg.xllh,yllh, 

zllh,xury,yury,zury} 

TmPUmixll,yll,xur,yur) 

TMPU3{xllh,yllh.zllh,' 
xury,yury,zury} 


Reset picture attribute of a 
segment. 

Modally set the 
already-existing picture to 
which subsequent segments 
are added. 

Test picture attribute of a 
segment. 

Test for maximum number 
of pictures postprocessor 
supports. 

Test for ID of current mode 
set picture. 


Modally set limits for 2-D 
picture coordinates. 

Modally set limits for 3-D 
picture coordinates. 

Test limits of the 2-D 
picture which contains the 
specified segment. 

Test limits of the 3-D 
picture which contains the 
specified segment. . 

Test limits of the current 
modally-set 2-D picture. 

Test limits of the current 
modally-set 3-D picture. 
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TA3D{idseg,l3D) Test dimensionality 

attribute of given segment. 

TIVI3D(ZSD) Test current mode for 

picture dimensionality. 


WINDOWS AND VIEWPORTS 


DEL XXX 

DELVUP(idport) 

DELWlN(idwind) 


VUPORx 

Y\]PORT{idport.xll,yll, 

xar.yur) 

Y\JPOR3{idport,xllh, 

yllh,zllh,xu.7y,yury, 

zury) 


WIN XXX 

WIN ChP{idwind,lclpnr, 
lclpfr,disner,disfar) 

WINDIR(idwind,xeye, 
yeye.zeye, xat,yat,zat) 

W IN D O W ( idwind,xll,yll, 
xar.yur) 

W IN PE R( idwind, Zp ersp) 


WINPLN(idwind,distat) 

WINSIZ(idwind,width. 

height) 


Delete specified viewport. 
Delete specified window. 

Define 2-D viewport ID and 
limits. 

Define 3-D viewport ID and 
limits. 


Define 3-D window 
clipping. 

Define 3-D line of vision. 

Define 2-D window ID and 
limits. 

Define 3-D window 
perspective. 

Define 3-D projection plane. 
Define 3-D window size. 
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WINUP(idwind,dxup, 

dyup,dzup) 


Define 3-D window up 
direction. 


xxPORT 
TFPORT( nport) 


TMPORT(idport) 

SMPORT(idport) 


Test for maximum number 
of viewports supported by a 
postprocessor. 

Test for current modally set 
viewport. 

Modally set viewport into 
which subsequent windows 
are mapped. 


xxSVP 

SMSVP(lscren,xll,yll, Modally set viewport to be 

xur,yur) used for system messages 

and user entries. 


TFSVP(lsysvp) Test for default system 

viewport separate from 
graphics area. 

TMSVPdscren.xll.yll, Test for viewport used for 

xur,yur} system messages and user 

entries. 


TRANSFORMATION MATRICES 

CLRSTx 

CLRSTK Clear 2-D transformation 

matrix storage stack. 

CLRST3 Clear 3-D transformation 

matrix storage stack. 
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POPx 


Replace CTM with matrix 
on top of 2-D 
transformation matrix 
storage stack. 

Replace CTM3 with matrix 
on top of 3-D 
transformation matrix 
storage stack. 


PUSHx 

PUSH 

Place copy of CTM on 2-D 
transformation matrix 
storage stack. 

PUSH3 

Place copy of CTM3 on 3-D 
transformation matrix 
storage stack. 

XIDNTx 

XIDNT(bmat23) 

Build 2-D identity matrix. 

XIDNT3(bmat34) 

Build 3-D identity matrix. 


XINVRx 

XIN VR(bmat23, binv23) 
Xl^VR3ibmat34,bmv34) 

XROTxx 

XROTA{deg,bmat23) 

XROT A 3{idaxis. deg, 
bmat34) 

XROTUddeg,bmat23) 


Build 2-D inverse matrix. 
Build 3-D inverse matrix. 

2- D absolute rotation. 

3- D absolute rotation. 

2-D relative rotation, left 
multiplication. 
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XR0TL3(idajcis,ddeg, 

bmat34) 

XROTR(ddeg,bma£23) 

X R 0 TR 3 ( idaxis ,ddeg, 
bmat34) 

XSCLxx 

XSCh A(sx,sy.bmat23) 
XSCLASisx,sy.sz,bmat34) 
XSCLLisdx,sdy,bmat23) 

XSCLL3(sdx,sdy,sdz, 

bmat34) 

XSCLRisdx,sdy,bmat23) 

X S C LR 3 ( sdx, sdy.sdz, 
bmat34) 

XTRNxx 

XTRNA(x,y,bma£23) 
XTRNA3(x.y,z,bmat34) 
XTR NL( dx.dy, bmat23) 

XTRNL3(dJC,dy,dz,bma£34) 

XTRNR(dj[:,dy.bma£33) 

XTRNR3(dJ(:.dy,dz,bma£34) 


3-D relative rotation, 
left multiplication. 

2- D relative rotation, right 
multiplication. 

3- D relative rotation, 
right multiplication. 


2- D absolute scale. 

3- D absolute scale. 

2- D relative scale, left 
multiplication. 

3- D relative scale, left 
multiplication. 

2- D relative scale, right 
multiplication. 

3- D relative scale, right 
multiplication. 


2- D absolute translation. 

3- D absolute translation. 

2- D relative translation, left 
multiplication. 

3- D relative translation, left 
multiplication. 

2- D relative translation, 
right multiplication. 

3- D relative translation, 
right multiplication. 
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xxXFxx 


RAXFA{idseg,bmat23) 

Absolutely reset 
transformation attribute of 
2-D segment. 

RAXFA3{idseg,bmat34) 

Absolutely reset 
transformation attribute of 
3-D segment. 

RAXFLiidseg,bmat23) 

Relatively reset 
transformation attribute of 
2-D segment, left 
multiplication. 

RAXFL3iidseg,bmat34) 

Relatively reset 
transformation attribute of 
3-D segment, left 
multiplication. 

RAX¥R{idseg,bmat23) 

Relatively reset 
transformation attribute of 
2-D segment, right 
multiplication. 

RAXFR3{idseg,bmat34) 

Relatively reset 
transformation attribute of 
3-D segment, right 
multiplication. 

SmX¥Aibmat23) 

Modally set absolute 2-D 
transformation. 

SMXFA3ibmat34) 

Modally set absolute 3-D 
transformation. 

SMXFUbmat23) 

Modally set relative 2-D 
transformation, left 
multiplication. 

SMXFL3ibmat34) 

ModaUy set relative 3-D 
transformation, left 
multiplication. 

SMXFR( bmat23) 

ModaUy set relative 2-D 
transformation, right 
multiplication. 

SMXFR3(bmat3<l) 

Modally set relative 3-D 
transformation, right 
multiplication. 
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TAXFA{idseg,hmat23) 

TAXFL(idseg,hmat23) 

TAXmiidseg,hmat23) 


TAXF A3{idseg,bmat34) 
TAXFL3(idseg,hmat34) 
TAXFR3iidseg,bmat34) 


TFXF Ailxlat,lscal,lrot) 
TFXFL(lxlat,lscal,lrot) 
TFXFR{lxlat,lscal,lrot) 

TFXF A3( lxfm3,lpersp, 
Ipyram) 

TFXFL3{lxfm3,lpersp, 

Ipyram) 

TFXFR3(lxfm3,lpersp, 

Ipyram) 

TMXFA(bmat23) 
TMXFL(bmat23) 
TMXFRi bmat23) 


TMXFA3(bmat34) 

TMXFL3(bmat34) 

TMXFR3(bmat34) 


GEOMETRY UTILITIES 


ENDPAR 

ENDPAR(cjc,cy,xJ,yi, 

x2,y2,narcs,xnl,ynl, 

xn2,yn2) 


ENDPLx 

ENDPLN(xl,yl,x2,y2, 

ishow,xnl,ynl,xn2, 

yn2) 

ENDPL3(xl,ylzl,x2, 

y2,z2,isho-w,xnl,ynl, 

znl,xn2.yn2,zn2} 


Test transformation attri¬ 
bute of 2-D segment; a 
copy of the matrix is placed 
in bmat23. 

Test transformation attri¬ 
bute of 3-D segment; a 
copy of the matrix is placed 
in bmat34. 

Test for terminal capabil¬ 
ity to perform 2-D trans¬ 
formations. 

Test for terminal capabil¬ 
ity to perform 3-D trans¬ 
formations. 


Test for current modally 
set 2-D transformation 
matrix; a copy of CTM is 
placed in bmat23. 

Test for current modally 
set 3-D transformation 
matrix; a copy of CTM is 
placed in bmat34. 


Determine endpoints of 
specified 2-D arc. 


Determine endpoints of 
specified 2-D line. 


Determine endpoints of 
specified 3-D line. 


I 
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RTANGx 


RTA}^GUxll,yll,xur,yur) 

RTA]^GZ{xllh.yllh.zllh, 

xury,yury,zwy) 

INTERACTION 

EVENT( ilcy.ids.coords, 
iremng) 

KRYBRD{maxchr,nchrs, 

itext) 

KYACiidky.iactn) 

KYOFF 

KYON 

LOCATE(x,y,iremng) 

PREEVN(lucord,idvuwO 

PRELOC(Zucord, idwwi) 

RROMPTinchar,itext) 


Define limits for 2-D 
endpoint calculations. 

Define limits for 3-D end¬ 
point calculations. 


Report terminal input to 
application program. 

Return to application pro¬ 
gram the text string entered 
from the terminal 
alphanumeric keyboard. 

Assign individual function 
key to action type. 

Assign all function keys to 
ignore action type. 

Assign all function keys to 
terminate action type. 

Report one or more sets of 
locator symbol coordinates. 

Specify coordinate system 
and window/viewport ID for 
EVENT processing. 

Specify coordinate system 
and window/viewport ID for 
LOCATE processing. 

Display message in system 
viewport area of screen. 
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xxAC 

RAAC(idseg,iactn) Reset action type attribute 

of segrnent. 

SMAC(iactn) ModaHy set action type. 


TAAC{idseg,iactn) 


Test action type attribute of 
segment. 


TFACilactn) 


Test for interaction support 
by postprocessor. 


TiVIAC(iactn) 


Test current modally set 
action type. 


xxID 

SMID(idintr) Modally set intrasegment 

identifier. 


TFID(md) 


TMlD(idmtr) 


Test for postprocessor 
support of return of 
intrasegment identifier. 

Test for current modally set 
intrasegment identifier. 


xxlNFO 

RAlNFOiidseg.mnfoMfo) 

SMINFOCninfo.info) 

TAINFO(idseg,nmfo, 

info) 

TMINFO(ninfo,info) 


Reset application 
information attribute of 
segment. 

Modally set information 
stored with segments. 

Test application attribute 
of segment. 

Test current modal setting 
for information stored with 
segment. 
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xxLOCR 



m 


SMLOCR(iZocr) Modally set locator device 

to be used. 

TFLOCRimaxloc.nlocrs, Test for number of loca- 
descrp,lone) tors (if any) supported and 

their characteristics. 

TMLOCR(iZocr) Test for current modally set 

locator device. 


ERROR PROCESSING 


lERROR 


IERRORC ierr) 


Check current error status. 




xxERR 

SMERR(routm) 


TFERR(Zroutn) 


TMERR(routm) 


Modally set error processing 
routine to be used when 
error is detected. 

Test for postprocessor 
support of user-supplied 
error routine. 

Test current modally set 
error processing routine. 


PARAMETERS 

The following are the parameters used in TIGS calling 
sequences. After each parameter is a description. The 
parameters are listed in alphabetical order. 

binv23 Output parameter; inverse matrix 

of bmat23; 2x3 array. 

binv34 Output parameter; inverse matrix 

of bmat34; 3x4 array. 
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bmat23 Input parameter; 2x3 array used 

for 2-D building matrix. 

bmat34 Input parameter; 3x4 array used 

for 3-D building matrix. 

cdx,cd.y,cdz Input parameters; user coordinates 

of arc center relative to current 
beam position. 

coords Output parameter; three-word 

array containing best effort 
coordinate values of the location of 
the segment pick. 

COORDS(l) = X coordinate 
COORDS(2) = y coordinate 
COORDS(3) = z coordinate (zero 
for 2-D picks) 

cx,cy,cz Input parameters; absolute user 

coordinates of arc center. 

Input parameters (ENDPAR); 
coordinates of arc center to be 
checked against boundaries 
specified by RTANGx. 

ddeg Input parameter; relative angular 

position of are endpoint, measured 
in degrees from the radius defined 
by arc center and current beam 
position. Positive values are 
counterclockwise (2-D) and in the 
direction of direction cosines 
(3-D). Negative values imply 
clockwise direction (2-D) and 
opposite to direction of the 
direction cosines (3-D). 

Input parameter (XROTL, XROTR, 
XROTL3, and XROTR3); relative 
number of degrees to rotate 
segment; positive values indicate 
counterclockwise rotation. 
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deg 


descrp 


disner,disfar 


distal 


Input parameter; absolute angular 
position of arc endpoint, measured 
in degrees counterclockwise from 
X axis. If negative, angular 
measurement is clockwise. 

Input parameter (SMROT and 
RAROT) or output parameter 
(TMROT and TAROT); specifies 
magnitude of rotation in degrees 
measured counterclockwise from X 
axis. 

Input parameter (XROTA and 
XROTA3); absolute number of 
degrees to rotate segment; positive 
values indicate counterclockwise 
rotation. 

Output array of size nlocrs 
describing the nlocrs locators for 
this postprocessor. Information for 
a given entry describes type of 
locator. 

Input parameters; specify clipping 
plane distances from center of 
attention. 

If LCLPNR = .FALSE., disner is 
meaningless. 

If LCLPFR = .FALSE., disfar is 
meaningless. 

Otherwise, these parameters 
specify directed distances along 
line of vision from center of 
attention to near and far clipping 
planes. Positive distances are 
away from the eye; negative 
distances are toward the eye. 

There are no defaults because 
overall defaults for WINCLP 
specify no clipping. 

Input parameter; specifies directed 
distance from center of attention 
to projection plane. Positive 
distances are away from the eye; 
negative distances are toward the 
eye. 
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dx,(iy,dz Input parameters; relative user 

coordinates of arc endpoint, dot, or 
line endpoint. 


Input parameters (XTRNL, 

XTRNR, XTRNL3, and XTRNR3); 
relative displacement in x, y, and z 
direction. 

dxary.dyary, Input array of length npoint 

dzary containing relative user 

coordinates of each endpoint, in 
sequence. Coordinates of each 
point are given relative to last 
point in array, not relative to 
initial beam position. 

dxup,dyup,dzup Input parameters; specify 

coordinates of a point relative to 
center of attention. Directed line 
segment from center of attention 
to this point defines up direction 
for the window; this line segment 
becomes the vertical axis when 
window is mapped to viewport. 

fdnam Input parameter; specifies name of 

neutral display file. 

A'nten Input parameter (SMINT and 

RAINT) or output parameter 
(TMINT and TAINT); indicates 
intensity level. Range is from 0. 
(dimmest) to 1. (brightest). 

height Input parameter; specifies height 

of viewing window on the 
projection plane, centered about 
the line of vision and parallel to 
the up direction. 

icLCtn Input or output parameter; 

specifies action to be performed 
when idky is pressed (KYAC) or 
action type (SMAC, RAAC, TMAC, 
TAAC) is selected. 

lACTN = 1 Ignore. 

lACTN = 2 Recognize. 

lACTN = 3 Terminate. 
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idat 

idaxis 

idintr 

idky 

idnew 

idold 

idpict 

idport 

ids 


Input parameter; array containing 
user data. 

Input parameter; axis about which 
to perform rotation for 3-D; 
specify as IHX, IHY, or IHZ. 

Input parameter (SMID) or output 
parameter (TMID); specifies 
intrasegment identifier. If idintr > 
nid.nid is used. 

Input parameter; number of 
function key to be assigned. 

Number of function keys available 
is postprocessor dependent. 

Input parameter; new ID of 
segment. 

Input parameter; ID of segment 
which is to be renamed. 

Input parameter (SMPICT and 
RAPICT) or output parameter 
(TMPICT and TAPICT); specifies a 
picture identifier. 

Input parameter; specifies ID of 
viewport. 

Output parameter; five-word array 
containing information about event 
reported by current call to 
EVENT. If event was a function 
key press (LKY = .TRUE.), IDS(l) 
contains function key ID. Other 
elements of array ids have no 
meaning, and coords parameter has 
no meaning. 
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idseg 

idvuwi 

idwind 

ierr 


If event was a segment pick (LKY 
•FALSE.), array ids has the 
following significance. 

Array 

Element Contents 

1 ID of picked segment. 

2 ED of window in which 

segment is displayed. 

3 ID of picture 

containing segment. 

4 ID of viewport in 

which segment is 
displayed. 

5 Intrasegment 
identifier (zero if no 
intrasegment ID). 

Input parameter; identifies 
segment whose attribute is to be 
tested, reset, deleted, or copied. 

Input parameter; ID of window or 
viewport in which initially to 
display the locator symbol. ID 
pertains to a window or viewport, 
depending on the value given for 
lacord. 

Input parameter; specifies ID of 
window. 

Output parameter; TIGS error 
number. 

If IERR = 0 [lERROR(IERR) = 0 if 
called as function], no error was 
detected. 

If IERR > 1 [lERROR(lERR) > 1 if 
called as function], IERR contains 
error number of detected error. 
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ifont Input parameter (SMFONT and 

RAFONT) or output parameter 
(TMFONT and TAFONT); specifies 
character font used. 

Range is 0 to 63. If IFONT > 
NFONT, NFONT is used. 

IFONT=l Use normal font. 

IFONT=2 Use italicized 

characters (if 
supported). 

IFONT=3 Use third font (if 
supported). 



IFONT=n Use nth font (if 
supported). 

IFONT=0 Reserved for future 
expansion. 

Number of supported fonts depends 
on postprocessor. 

ilocr Input parameter (SMLOCR) or 

output parameter (TMLOCR); 
specifies locator. Ordinals specify 
corresponding members of descrp 
array; that is, ILOCR=l specifies 
locator described in DESCRP(l). If 
ilocr > nlocrs, the highest 
numbered locator is used. 

info Input parameter (SMINFO and 

RAINFO) or output parameter 
(TMINFO and TAINFO); name of 
array containing or to contain 
application information. 

iremng Output parameter; specifies 

number of events remaining on the 
event queue for EVENT calls or 
number of locations remaining on 
the locate queue for LOCATE 
calls. 
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ishow Output parameter; specifies result 

of boundary check. 

If ISHOW=0, line lies outside area 
or volume and endpoints are 
meaningless. 

If ISHOW=l, line lies totally within 
area and new endpoints are same as 
original endpoints. 

If ISHOW=2, first endpoint is 
clipped and at least one of the 
following relationships is true. 

xlT^xnl 

yl=^nl 

zl^znl 

If ISHOW=3, second endpoint is 
clipped and at least one of the 
following relationships is true. 

x2^xn2 

y2^yn2 

z2^zn2 

If ISHOW=4, both endpoints are 
clipped and at least one of the 
following relationships from each 
column is true. 

xli^xnl x 29 ^xn 2 

yljtynl y2tyn2 

zli^znl z2^zn2 

istyle An input parameter (SMSTYL and 

RASTYL) or output parameter 
(TMSTYL and TASTYL); specifies 
line style. 

1 Solid lines. 

2 Long dashed lines. 

3 Short dashed lines. 

4 Dash-dotted lines. 

5 Dotted lines. 

>5 Bit pattern line style. 
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isym 

itext 

lactn 

Icchar 

Idpnr.lclpfr 


leant 

Idelet 


Input or output parameter; 
specifies symbol used. 

Input array containing nchar 
characters to be drawn. Maximum 
characters per word is machine 
dependent. Output parameter 
(KEYBRD); first word of array 
containing text string. 

Output parameter; if LACTN= 
.TRUE., EVENT subroutine is 
supported by postprocessor; 
otherwise, it is not. 

Output parameter; if LCCHAR= 
.TRUE., postprocessor supports 
continuous character sizes. 

Input parameters; specify clipping 
planes. 

If LCLPNR^.TRUE., clipping is 
done to the near clipping plane; 
otherwise, it is not. 

If LCLPFR=.TRUE., clipping is 
done to the far clipping plane; 
otherwise, it is not. 

Output parameter; if LCONT= 
.TRUE., continuous character 
rotation is supported by either 
terminal hardware or by TIGS 
software. 

Input parameter; specifies whether 
neutral display file used by 
program is to be saved or discarded 
when QUITIG is called. 

If LDELET=.TRUE., neutral display 
file is discarded. 

If LDELET=.FALSE., neutral 
display file is not discarded. 
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Mown 


lhard 


Ihilit 


Ihilt 


Input parameter; specifies whether 
picture will be seen in associated 
windows. 


If LDOWN=.TRUE., blinds are down 
and no part of picture will be seen 
in any window. 

If LDOWN=.FALSE., blinds are up 
and picture is visible in all 
associated windows. 


Output array of six logical 
variables specifying what line 
styles are supported by terminal 
hardware. 


LHARD(1)=.TRUE. 

LHARD(2)=.TRUE. 

LHARD(3)=.TRUE. 

LHARD(4)=.TRUE. 

LHARD(5)=.TRUE. 

LHARD(6)=.TRUE. 


Solid line style 
supported. 

Long dashed 
line style is 
supported. 

Short dashed 
line style is 
supported. 

Dashed-dotted 
line style is 
supported. 

Dotted line 
style is 
supported. 

Bit pattern 
line style is 
supported. 


Input parameter (SMHILT and 
RAHILT) or output parameter 
(TMHILT and TAHILT); indicates 
highlighting mode or attribute. If 
LHILT=.TRUE., affected segments 
are highlighted; otherwise, they are 
not. 

Output parameter; if 
LHILT=.TRUE., highlighting is 
supported; otherwise, it is not. 


I 28 


60456360 B 



line Input logical variable specifying 

whether lines are to be drawn 
between plotted points. Applies, to 
all points in plot. 

If LINE=.TRUE., lines are drawn 
between endpoints, starting at 
current beam position. 

If LINE=.FALSE., no lines are 
drawn. 

Symbol is plotted regardless of 
value of line. 

Iky Output parameter; indicates 

whether event was function key 
press or segment pick. 

If LKY=.TRUE., event was a 
function key press. 

If LKY=.FALSE., event was a 
segment pick. 

Ininty Output parameter; if LNINTY= 

.TRUE., terminal hardware 
supports 90-degree character 
rotation. 

Inwfil Input parameter; specifies whether 

the neutral display file is new or 
old. 

If LNWFIL=.TRUE., new neutral 
display file will be created by this 
graphics program. 

If LNWFIL=.FALSE., this program 
will use old neutral display file. 

Ion Input parameter; turn alarm on or 

off. 

If LON=.TRUE., turn alarm on. 

If LON=.FALSE., turn alarm off. 

lone Output logical array of size nlocrs; 

if LONE(l)=.TRUE., then 
DESCRP(l) is a one-shot locator. 
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Ipersp 


Ipyram 


Iremot 


Irot 


Iroutn 


Irtang 


Iscal 


Input parameters; specify 3-D 
perspective type. If 
LPERSP=.TRUE., window has a 
perspective projection. 

If LPERSP=.FALSE., window has a 
parallel (axonometric) projection. 

Output parameter (TFXFA3, 
TFXFL3, and TFXFR3); if 
LPERSP=.TRUE., perspective 
preservation during 3-D 
transformation is hardware 
supported; otherwise, it is not. 

Output parameter; if 
LPYRAM=.TRUE., cHpping to 3-D 
window pyramid during 
transformations is hardware 
supported; otherwise, it is not. 

Output parameter; if 
LREMOT=.TRUE., remote 
hardcopier exists. 

Output parameter; if 
LROT=.TRUE., 2-D rotation is 
hardware supported; otherwise, it 
is not. 

Output parameter; if 
LROUTN=.TRUE., user-supplied 
error routine is supported; 
otherwise, it is not. 

Output parameter; describes screen 
shape and dimensions. 

If LRTANG=.TRUE.. terminal 
screen is rectangular. 

If LRTANG=.FALSE., terminal 
screen is circular. 

Output parameter; if 
LSCAL=.TRUE., 2-D sealing is 
hardware supported; otherwise, it 
is not. 
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Iscren 


Isquar 


Isysvp 


Itran 


Input parameter (SMSVP) or output 
parameter (TMSVP). 

If LSCREN^.TRUE., system 
viewport coordinates are given in a 
terminal-independent coordinate 
system. 

If LSCREN=.FALSE., system 
viewport coordinates are given in 
terminal-dependent coordinate 
system. 

Input parameter; defines mapping 
of screen coordinates onto terminal 
display surface. 

If LSQUAR=.TRUE., map screen 
coordinates onto largest square 
possible on terminal display surface. 

If LSQUAR=.FALSE., use entire 
terminal display surface. 

Output parameter. 

If LSYSVP=.TRUE., postprocessor 
supports a default system viewport 
that is guaranteed separate from 
the area of screen used for 
graphics displays. 

If LSYSVP=.FALSE., default 
viewport is not guaranteed 
separate. Dependent on Isqaar 
value given in INITIG routine. 

Output parameter; if 
LTRAN=.TRUE., retransmission of 
data to the screen is necessary to 
make a visible segment invisible. 
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lucord Input parameter; specifies 

coordinate system for returned 
coordinates and type of ID 
specified by idvuwi. 

If LUCORD=.TRUE., coordinates 
are returned as user coordinates; 
idviLwi specifies the ID of a window. 

If LUCORD=.FALSE., coordinates 
are returned as screen coordinates; 
idvuwi specifies the ID of a 
viewport. 

Ivis Input parameter (SMVIS and RAVIS) 

or output parameter (TMVIS and 
TAVIS); indicates visibility mode or 
attribute. If LVIS=.TRUE., 
affected segments are visible; 
otherwise, they are not. Visibility 
mode may not be changed during 
segment definition; entire segment 
is either visible or invisible. 

Ixfm3 Output parameter; if LXFM3= 

•TRUE., all 3-D transformation 
functions are hardware supported; 
otherwise, they are not. 

Ixlat Output parameter; if 

LXLAT=.TRUE., 2-D translation is 
hardware supported; otherwise, it 
is not. 

13d Output parameter; if L3D=.TRUE., 

the current modal setting or 
attribute is 3-D; otherwise, it is 
2-D. 

maxchr Input parameter; maximum number 

of characters permitted in string. 

maxloc Input parameter; size of the arrays 

descrp and lone. 
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narcs 

nchar 

nchrs 

newseg 

nfont 

nid 

ninfo 

ninten 

nlocrs 

npict 

npoint 

nport 

nsize 

60456360 B 


Output parameter; contains the 
number of arc sections that are 
inside area specified by RTANGL. 
If NARCS=0, xnl,ynl,xn2,yn2 are 
meaningless. 

Input parameter; number of 
characters in text string. 

Output parameter; number of 
characters contained in array itext 
up to and including last nonblank 
character. 

Input parameter; identifier to be 
assigned to copy. 

Output parameter; indicates 
number of character fonts 
supported. 

Output parameter; largest number 
supported by postprocessor for 
intrasegment identifiers; if NID=0, 
the feature is not supported. 

Input parameter; number of words 
in info array. 

Output parameter; indicates 
number of discrete intensity levels 
supported. 

Output parameter; total number of 
locator devices supported by 
postprocessor up to maxloc. 

Output parameter; indicates 
maximum number of pictures 
supported by postprocessor. 

Input parameter; number of 
endpoints in each array (same for 
all arrays). 

Output parameter; specifies 
maximum number of viewports 
supported by postprocessor. 

Output parameter; specifies 
number of discrete character sizes 
supported. 
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nsym 

nwords 

resltn 

routin 

sdx,sdy,sdz 

sx,sy,sz 

mde.high 

widout.hiout 

width 


Output parameter; indicates 
maximum symbol number for which 
a symbol is defined. 

Input parameter; number of words 
in idat array. 

Output parameter; value expressing 
ability of the terminal screen to 
resolve images. 

Input parameter (SMERR) or output 
parameter (TMERR); specifies the 
address of the error routine. 

Input parameters; relative scale 
factors in x, y, and z axes. 

Input parameters; absolute scale 
factors in x, y, and z axes. 

Input parameters; specifies width 
and height of desired character 
size as fractions of screen size for 
RADSIZ and SMDSIZ and in user 
coordinates for RACSIZ and 
SMCSIZ. 

Output parameters; specifies width 
and height of hardware discrete 
character size that best 
approximates desired size (TFDSIZ) 
or character size that is being used 
(TMDSIZ and TADSIZ) or specifies 
width and height of character box 
being used for continuous 
characters (TMCSIZ and TACSIZ). 

Input parameter; specifies width of 
viewing window on projection 
plane, centered about the line of 
vision and perpendicular to the up 
direction. 
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x,y,z Input parameters; absolute user 

coordinates of arc endpoint, dot, 
line endpoint, or locator symbol. 

Input parameters (XTRNA and 
XTRNA3); absolute displacement in 
X, y, and z direction. 

xary.yary,zary Input arrays of length npoint 

containing absolute user 
coordinates of each endpoint, in 
proper sequence. 


xat,yat,zat Input parameters; specify 

coordinates of center of attention. 
This point and the eye position 
point define a line of vision. 


xbase,ybase, Input parameters (SMROT3 and 

zbase,xplane, RAROT3) or output parameters 

yplane.zplane (T1VIROT3 and TAROT3); specify 

base and plane vectors in relative 
user coordinates to define 3-D 
character rotation and plane. 


xdir,ydir,zdir Input parameters; direction cosines 
defining direction of 3-D arcs. In 
special cases of semicircles and 
full circles, direction cosines also 
define the plane of the arc. 


xeye.yeye.zeye Input parameters; specify 

coordinates of a point to be used as 
the viewer’s eye position. 


xll.yll.xur.yur Input parameters; specify user 

coordinates of lower left and upper 
right corners of a 2-D window. The 
conditions 


xU <xar 
yll <yur 

must be satisfied for WINDOW. 
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Input parameters (SMPLIM) or 
output parameters (TMPLIM and 
TAPLIM); specify user coordinates 
of lower left and upper right 
corners of the picture, screen area 
(SMSVP and TMSVP), or rectangle 
used by ENDPLN and ENDPAR 
subroutines (RTANGL). 


Input parameters; specify user 
coordinates (WINDOW) or screen 
coordinates (VUPORT) of lower 
left and upper right corners of the 
2-D window or viewport. 

xllh,yllh,zllh, Input parameters; specify screen 
xury,yury,zury coordinates of lower left hither and 
upper right yon corners of viewport 
space. ' 

Input parameters (SMPLI3) or 
output parameters (TMPLI3 and 
TAPLI3); specify user coordinates 
of lower left hither and upper right 
yon corners of picture or 3-D 
parallelepiped used by ENDPL3 
subroutine (RTANG3). 

xnl,ynl,znl, Output parameters; coordinates 

xn2,yn2,zn2 of intersections of line with 

boundaries of area/volume (new 
endpoints). For ENDPAR, each is 
dimensioned as an array of five 
words. 


xscrn,yscrn 


Input parameters; screen 
coordinates to be converted. 


xuser,yuser 


xl,yl,zl,x2,y2, 

z2 


Output parameters; user 
coordinates converted from screen 
. coordinates. 

Input parameters; endpoints of 
line to be checked against 
boundaries specified by RTANGx. 

Input parameters (ENDPAR); 
coordinates of the endpoints of the 
arc. 
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DEFAULT PARAMETER VALUES 


The following are the default values assigned if the user 
does not assign a value. 


Default 


Routine 

Parameter(s) 

Value 

Description 

BLINDS 

Mown 

FALSE 

Blinds up - picture 
visible. 


idpict 

0 

Default picture. 

INITIG 

Isquar 

TRUE 

Map screen 
coordinates so 
that graphics area 
is square and 
there is room for 
a separate system 
viewport. 


Inwfil 

TRUE 

New neutral 
display file will be 
created. 


filnam 


Postprocessor- 
dependent. ' 

KYAC 

iactn 

3 

Terminate. 

PREEVN 

Mvuwi 

0 

Default viewport. 


lucord 

FALSE 

Coordinates 
return as screen 
coordinates. 

QUITIG 

Idelet 

TRUE 

Neutral display 
file is discarded. 

WIN XXX 

xll.yll 

0,0 

X and y values of 
lower left corner 
(default picture 
only). 


xar.yur 

1,1 

X and y values of 
upper right corner 
(default picture 
only). 


Iclpnr, 

Iclpfr 

FALSE 

Clipping is not 
done. 
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Routine 

Parametep(s) 

Default 

Value 

Description 


jceye 

xury+- 

(xury~ 

xllh) 

On positive x- 
axis at a dis¬ 
tance from the 
picture limit box 
equal to the width 
of the box in the 

X- direction. 


yeye 

yury+yllh 

2 

Center of y-axis 
picture limits. 


zeye 

zury+zllh 

2 

Center of z-axis 
picture limits. 


xat,yat, 

zat 


Center of picture 
limits. 


Ipersp 

TRUE 

Window has 
perspective 
projection. 


distat 

0 



width 

yury-yllh 

Width of picture. 


height 

zury,zllh 

Height of picture. 


dxup,dyup, 

dzup 

0,0,1 

Parallel to posi¬ 
tive z-axis. 

XX AC 

iactn 

3 

Terminate. 

xxDSIZ 

wide,high 

.0125, 

.0167 

Hardware charac¬ 
ter size most 
closely approxi¬ 
mating these 
values. 

xxERR 

routin 

NULL 

Error routine 
named NULL. 

xxFONT 

ifont 

1 

Normal font. 

xxHILT 

Ihilit 

FALSE 

Affected 
segments not 
highlighted. 

xxINFO 

ninfo 

0 

No information. 
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Routine 

ParameteHs) 

Default 

Value 

Description 

xxINT 

finten 

.5 

Medium intensity. 

xxLOCR 

ilocr 

1 

Found in descrp(l). 

xxPLIx 

xlhyll 

0,0 

Lower left corner 
is (0,0). 


xur,yur 

1,1 

Upper right 
corner is (1,1). 

xxROT 

deg 

OO 

No rotation. 

XXROT3 

xhase, 

l.,0.,0. 

X-axis for base 


ybase, 

zbase 

xplane, 

yplane, 

zplane 

0 ., 1 ., 0 . 

and y-axis as up 
direction. 

xxSTYL 

istyle 

1 

Solid line. 

xxSYM 

isym 

-1 

No symbol 
assigned. 

xxVIS 

Ivis 

TRUE 

Segments visible. 
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ERROR MESSAGES 


WARNING MESSAGES 


Illegal ID Errors (1-100) 

Error 

Number Cause 

1 Attempt to use an idseg that is undefined 
or open when it should not be. 

2 Attempt to change the picture attribute 
of a segment to a nonexistent idpict. 

3 Attempt to delete or put blinds on a 
nonexistent picture. 

4 ID of window is not defined. 

5 ID of viewport is not defined. 

6 Attempt to open or extend a segment 
when one is already open. 

10 Attempt to extend a picture that does 
not exist. 

11 Attempt to extend a segment that does 
not exist. 


Character or Word Count Errors (101-200) 

Error 

Number Cause 

102 npoint<0 on a plot call. 

103 maxchr<0 on a request for keyboard 
input. 

104 nwords<Q or nwords> 26 on User Data 
specification. 

105 Number of characters in prompting 
message of text string is out of range 
(nchars<0 or nchars >256). 
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Clipped and Undipped Beam Position Errors (201-3C 


Error 

Number 

Cause 

201 

Clipped (to picture limits) and undipped 
beam positions unequal when picture was 
closed and now programmer wishes to 
extend picture. 

202 

Clipped and undipped beam positions 
unequal when segment was closed and 
now programmer wishes to extend 
segment. 

Unsupported 

Postprocessor Features (301-400) 

Error 

Number 

Cause 

301 

Request for unsupported font. 

302 

Request for unsupported intensity. 

303 

Request for unsupported plotting symbol. 

304 

Request for highlighting when 
highlighting is not supported. 

305 

Request for continuous characters when 
not supported. 

Reserved Warning Numbers (401-900) 

Reserved. 


Miscellaneous Errors (901-1000) 

Error 
' Number 

Cause 

901 

Primitive encountered and no open 
segment. 

902 

Mode set locator is 0 and user wishes to 
specify locations. 
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903 


Attempt to pop an empty 2-D 
transformation stack. 


904 Attempt to pop an empty 3-D 

transformation stack. 


SERIOUS ERROR DIAGNOSTICS 


Primitive Sp 

ecification Errors (1001-1100) 

Error 

Number 

Cause 

1001 

Arc center outside picture limits. 

1002 

Radii not approximately equal. 

1003 

Radius <0. 

1004 

Relative degrees of arc approximately 0. 

1005 

Sum of squares of direction cosines 9^1. 

1006 

Direction cosine vector is coincident 
with or parallel to the vector from the 
start point to the center point. 

Segment, Picture, Window, or Viewport Errors 

Error 

Number 

Cause 

1101 

Attempt to extend a locked segment. 

1102 

idwind out of range {idwind<0 or 
idwind>32767). 

1103 

idport out of range (idportSO or 
idport >32 767). 

1104 

idpict out of range (idpict^O or 
, idpict>32767). For BLINDS legal range 
is 0<idpict<32767. 

1105 

idsegout of range (idseg£0 or 
idseg>32767). 
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1106 

Viewport or system viewport limits are 
invalid. 

1107 

Window limits outside range of picture 
limits or lower left corner not less than 
upper right corner. 

1108 

Attempt to define a window on the 
default viewpoint. 

1109 

Attempt to delete the modally set 
picture. 

1110 

New segment ID is already defined. 

1113 

idseg already defined. 

1114 

idpict already defined. 

1115 

Eye position is the same as the center of 
attention. 

1116 

width or height of window<0. 

1117 

Zero-length up direction vector specified. 

1118 

Far clipping plane is closer to eye than 
near clipping plane or clipping planes are 
coincident. 

1119 

Up direction is parallel to the line of 
sight. 

1120 

Near or far clipping plane is not in front 
of the eye. 

1121 

Projection plane is not in front of the 
eye. 

'o-/Th ree 

-Dimensional Intermixing Errors (1201 

Error 

Number 

Cause 

1201 

Attempt to put a 2-D window on a 3-D 
picture. 

1202 

Attempt to put a 2-D primitive or 2-D 
transformation in a 3-D segment. 
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1203 2-D locations requested when location 

queue is 3-D. 

1205 Window or viewport is 3-D and both 
should be 2-D. 

1206 Attempt to put a 3-D primitive or 3-D 
transformation in a 2-D segment. 

1207 Attempt to put a 3-D segment in a 2-D 
picture or attempting to put a 2-D 
segment in a 3-D picture. 

1208 Attempt to put a 3-D window on a 2-D 
picture. 

1209 Attempt to put a 3-D window in a 2-D 
viewport. 

1210 Attempt to modify a 2-D window with 
3-D information. 

1211 Attempt to "LOCATE" (2-D) in a 3-D 
window; conversion to user coordinates is 
not possible. 

1212 Segment picked was in a 3-D window and 
EVENT (2-D) was caUed. 

1213 Attempt to modify a 3-D window with 

2- D information. 

1214 Attempt to modify a 2-D viewport with 

3- D information. 

1215 Attempt to modify a 3-D viewport with 
2-D information. 

1216 3-D routine was called where a 2-D call 
should have been made. 

1217 2-D routine called where a 3-D call 
should have been made. 
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Set Mode or Reset Attribute Errors (1301-1400) 


Error 

Number 

Cause 

1301 

Intensity out of range {finten<Q. or 
fmten>l.) 

1302 

Font value out of range UfonKQ or 
ifont>63). 

1303 

Action type out of range (iactn<0 or 
iactn>3). 

1304 

Function key number out of range 
{idky<Q or idky>255). 

1305 

Plot symbol number is out of range 
(isym<0 or isym>32767). 

1306 

Line thickness percentage is out of range 
{percnt<Q, or percnt>100.) 

1307 

Intrasegment ID is out of range {idmtr<0 
or idintr>32767). 

1308 

Number of words of application-related 
information is out of range {ninfo<Q or 
mnfo>4). 

1309 

Locator code is out of range (ilocr<Q or 
iIocr>63). 

1310 

Line style values is out of range iistyle<0 
or istyie>4095). 

1320 

Attempt to change action attribute of a 
segment after a primitive has been 
defined. 

1321 

Attempt to set picture limits after a 
primitive or closed segment has been 
defined. 

1322 

Attempt to modify the visibility 
attribute of a segment after the first 
primitive has been defined. 

1323 

Attempt to change highlighting attribute 
of a segment after a primitive has been 
defined. 
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1324 Base and plane vectors are colinear. 

1325 Character height or width<0. 

Symbol Table (IDLIST) Overflow (1401-1500) 
Error 


Number 

Cause 

1401 

Symbol table overflow on opening a 
picture. 

1402 

Symbol table overflow on opening a 
segment. 

1403 

Symbol table overflow on defining a 
viewport. 

1404 

Symbol table overflow on defining a 
window. 

Reserved Serious Error Numbers (1501-3900) 

Reserved. 

Miscellaneous 

Errors (3901-4000) 


Error 

Number Cause 

3901 xllh>XLLry or yllh^yary or zllh>zury 

3902 Requested locator does not exist. 

3903 Attempt to hardcopy on a nonexistent 
'hardcopier. 

3904 Attempt to rotate about an undefined 
axis. 

3905 Attempt to invert a 2-D singular matrix. 

3906 Attempt to invert a 3-D singular matrix. 
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3907 Attempt to reset continuous character 
size attribute of a segment with a 
discrete character size attribute. 

3908 Attempt to reset discrete character size 
attribute of a segment with a continuous 
character size attribute. 

3909 Mode set or attribute character size is 
discrete and a continuous character size 
test routine was called. 

3910 Mode set or attribute character size is 
continuous and a discrete character size 
test routine was called. 


Data Manager Detected Errors (4001-5000) 
Error 

Number Cause 

4001 No data file or in-core block space 
available. 

4002 The version number of the old file does 
not match the current TIGS version 
number. 


I NOTE I 

The following error numbers, 4100-4109, 
occur if an application is run when a 
neutral display file from a previous run 
has not been returned. QUITIG called 
with LDELET=.TRUE. returns the NDF. 
Refer to Data Handler Reference Manual 
for details. 


4100 Illegal bead address passed to internal 
routine DMDMP. 

4101 The file to be dumped by internal routine 
DMDMP has not been initialized. 
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4102 

File to be accessed has not been 
initialized. 

4103 

Block count limit exceeded. 

4104 

File is not in the correct format to be 
processed by the TIGS data manager. 

4105 

Internal data handler array, IBLK, is too 
short. 

4106 

Internal common block /ZLDMTB/ loaded 
after internal array IBLK. 

4107 

Illegal bead address passed to internal 
routine DMRLBD. 

4108 

Elegal bead address passed to internal 
routines DMSET or DMGET. 

4109 

Illegal component type code passed to 
internal routines DMSET or DMGET. 


TIGS Reserved Error Numbers (5001-10000) 
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